CURSOR

Syntax: CURSOR [#channel,] [grx, gry,] x,y
    or: CURSOR [#channel,] flag                  (Btool only)
Location: QL ROM, Btool

The CURSOR command allows you to set the text cursor to a specific position in the given window (default #1).  Any text which is then printed will appear with the given position at its top left corner.

The values x and y specify the position in pixel co-ordinates relative to the origin of the specified window (eg. if the window #1 was defined as scr_448x200a32x16, the command CURSOR 224,100 will set the text position to the exact centre of the window).

However, for the more adventurous, CURSOR can take an additional two parameters which allow you to mix text and graphics on a given window more easily. This sets the text cursor to the graphics co-ordinate (grx,gry) and then uses the x and y parameters to specify a relative pixel offset from this graphics co-ordinate.

The second variant only works with the Btool Toolkit. This allows you to enable or disable the cursor in the specified window (default #1), by specifying a flag of 1 to enable the cursor or 0 to disable the cursor.

NOTE:
On pre MG ROMs, the CURSOR command only allows a maximum of four parameters.
The Btool variant fixes this as does SMS, MG ROMs and Minerva.

CROSS-REFERENCE:
Please refer to PRINT, LEFT and AT.
CURSEN is a more compatible means of enabling a cursor.
